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(54) Software updating method 

(57) A method for use in upgrading a resource of a 
computer from an existing version of the resource to a 
later version of the resource. The method includes the 
steps of (a) digitally storing upgrade information which 
identifies the later version and describes features of the 
later version relative to one or more earlier versions of 
the resource, (b) digitally storing in the computer infor- 
mation identifying the existing version, by computer, 
automatically determining which of the earlier versions 



is the existing version, ard (c) based on the results of the 
comparing step, autorratically determining, or displaying 
to a user at least some of the upgrade information to aid 
the user in determining, whether to perform an upgrade. 
The upgrade information may be stored on a portable 
medium along with copies off the resources and the 
upgrade information may include instructions, in accord- 
ance with a predefined common syntax, for installing 
each of the resources. 
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Description 

This invention relates to automatic computer upgrading. 

The user of a computer system (e.g.. a stand-aJone PC or a network) is usually concerned with maintaining maximum 

5 utility and efficiency of system resources while at the same time minimizing the cost, in time, money and frustration, of 
maintaining the system. System resources, e.g., system firmware, software applications, operating systems (OS). OS 
drivers and system partition utilities, are frequentiy upgraded by the manufacturer Therefore, to effectively balance 
system utifity with the costs of the system, the user frequently would have to perform a detailed analysis of the available 
upgrades and the effect those upgrades would have on the user's system. 

10 During such an analysis, the user would have to compare the version number of each system resource to that of 
its upgrade to determine whether or not an upgrade is available. When an upgrade is available, the user would have to 
understand the differences between tine system version of the resource and the corresponding upgrade, as well as how 
these differences would affect (i.e.. improve or diminish) the capabilities of the computer system. 

Even when the user is able to determine with accuracy the benefits of an upgrade to the system, the user is almost 

IS never able to determine how an upgrade will impact a resource that is not upgraded. It is not uncommon for an upgrade 
to reduce the ability of a resource to properly function with another resource. In addition, upgrades often exist solely to 
repair hidden bugs which may not have surfaced on the user's system, a situation in which the user almost always 
ignores the upgrade until the bug is encountered, usually resulting in lost information. 

Many resource manufacturers address some of these problems by making certain aspects of the upgrade determi- 

20 nation easier for the user. The NetWare Management System by Novell inspects network loadable modules (NLMs) on 
a network server to determine the current version of the NLM. its most recent revision level, and the revision date. Thus. 
NMS not only tells the user which resources are currerrtfy on the system, but also provides information that allows the 
user to easily determine whether or not upgrades are available. Likewise, the Frye Utilities NetWare Management pro- 
gram provides the titles and version nunribers of NLMs on the server. Manufacturers also usually provide descriptions 

25 of the changes made from one version of a resource to the next. Nevertheless, despite the availability off this type of 
infonration, the user. In general, either never upgrades or upgrades whether it is needed or not 

In g^eral, In one aspect the invention features a method for use in upgrading a resource of a computer from an 
existing version of the resource to a later version of the resource. The method includes the steps of (a) digitally storing 
upgrade infbnnation which identifies the later version and describes features of the later version relative to one or more 

30 earlier versions of the resource, (b) digitally storing in the computer information identifying the existing version, by com- 
puter, automatically determining which of the earlier versions is the existing version, and (c) based on the results of the 
comparing step, automatically determining, or displaying to a user at least some of the upgrade information to aid the 
user in determining, whether to perform an upgrade. 

Implementations of the invention include the following features. The upgrade information may be stored on a portable 

35 medium, the later version of the resource may also be stored on the portable medium, and the upgrade information may 
identify the location of the resource on the portable medium. The portable medium may be a CD-ROM. and may contain 
stored later versions of multiple resources, and upgrade information with respect to each of the resources. 

The upgrade infornriation may be stored in the form of a database, and may include instructions for installation of 
the resource. The instaDation instructions may^e expressed in accordance with a predefined common syntax. The 

40 resource may include a complete standabne software package, or less than all of a complete standalone software 
package. 

The Mpgrade may be automatically performed on a network server, or on a network client In the latter case the 
upgrade may be performed via the network, or by automatically storing the later versk>ns and installation instructions 
on a portable storage medium for manual installation on the client 
45 The upgrade information may include information concerning reasons for the later version, and an indication of the 
type of change from a prior version to the later version (e.g., feature enhancement performance enhancement, or bug 
fix). The upgrade information also may include an irxiication of the inportance of the change from the prior version to 
the later version, and information identifying other resources that must be upgraded before the resource may be 
upgraded. 

50 In general, in another aspect tine invention features supplying later versions of resources for upgrading existing 
versions, by storing copies of the resources and upgrade information which identities the later versions, describes fea- 
tures of the later versions relative to one or more earlier versions off the resource, and provides instructk>ns, in accord- 
ance with a predefined common syntax, for installing each of the resources. The copies of the resources and tiie upgrade 
information may be stored on a portatrie storage medium or within an on-line sendee. 

55 Among the advantages of the invention are the following. The invention automatically determines the availability of 
upgrade to resources on a computer system. The invention may also determine the importance of each of the upgrades. 
In axkMon, information regarding dependencies between upgrades is provided. As a result, the user can, with littie effort, 
make an educated determination of wNch resources should and should not be i^raded at a particular time. Resources 
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to be upgraded may be selected automatically, and the upgrades may be made automatically In a network environment 
or manually using automatically generated upgrade diskettes. 

Other advantages and features will become apparent from the following description arKi from the claims. 
Rgure 1 is a functional block diagram of a network server and a server manager, including an automatic upgrade 
5 device. 

Rgure 2 is a functional block diagram of a server and a server manager daring an automatic upgrade. 

Rgure 3 is a flow diagram for automatically updating resources on a network server. 

Rgure 4 is a diagram of components of a management information base. 

Rgures 5A-5C are templates for records in an upgrade database. 
10 Rgure 5D is a functional block diagram of components of an upgrade datafc>ase. 

Rgure 6 is a functional block diagram off an upgrade advisor. 

Rgures 7A-7B and 8 are flow diagrams for upgrade advising. ' 

Rgures 9 and 10 are screen shots of a graphical user interface for an upgrade advisor. 

Rgure 11 is a functional block diagram of components of a dient of the network server. 
IS Referring to Rgure 1 , a network server 1 provides network resources 3 to a network of client computers (not shown). 
Network resources include firmware, software applications, operating systems (OS). OS drivers and hardware drivers. 
A management information base (MIB) 5 witiiin the server 1 maintains basic descriptive information about each of the 
resources 3 available on the server 1 . Included in the MIB 5 are the name and version number of each piece of software, 
its location in the server, and the date and time of its release. The information in the MIB 5 ensures that the server 1 
20 always has a current record of the resources 3 it provides to the network. 

Upgrades 7 to tiie network resources 3 are provkjed to a server manager 2 by a distribution medium (not shown), 
such as a CD-ROM. The upgrades 7 may also be provided by an on-line service (not shown), such as a Ixjiletin board 
service administered by a rranufacturer of network resources. The basic units of the upgrades 7 are upgrade objects 
8. each of which corresponds to an individually upgradable network resource 3. The upgrade objects are grouped into 
25 upgrade packages 6 which correspond to resource 3 groupings on tiie server. A package 6 may contain any number of 
upgrade objects 8 (i.e.. may upgrade any nunlber of individual network resources 3), including only a single object 8. 

In addition to the resource upgrades 7. the CD-ROM contains an upgrade datalsase 9. which stores information 
about each of the upgrade packages 6 {e.g., name and location of the package on the CD-ROM. description of the 
upgrades, and instructions for installation of the package to the server), and tiie individual upgrade objects 8 within each 
30 package 6. If the upgrades 7 are provided by an on-line service, the upgrade database 9 will also be provkied by the 
service. 

The server manager 2 oversees the network resources 3 stored on the server 1 . An upgrade device 1 0 in the server 
manager 2 is responsble for automatically analyzing and executing the resource upgrades 7 available to the server 1 . 
When the upgrades 7 become available to the network (e.g., by inserting the CD-ROM into the server manager drive. 

35 or by logging into the on-line servk:e). an upgrade advisor 11 in the upgrade device 10 automatically analyzes each 
network resource 3 currentiy on the server 1 to determine the availability and necessity of the corresponding upgrade 
7. When the analysis is complete, the upgrade advisor 1 1 presents a report and/or graphical display to the user. This 
output is in the form of upgrade recommendations, each supported by an explanation of the reasons for upgrade. The 
results may also be used to create upgrade diskettes. 

4o To determine wtiich upgrades 7 should be installed to the server, the upgrade advisor 1 1 retrieves information about 
the MIB 5 from a server database 1 3 located in the server manager. The server database 13 tells the upgrade advisor 
1 1 tfie location of each piece of information contained in the MIB. The upgrade advisor 1 1 supplies the location irrfbr- 
mation to a data retriever 15. which uses it to retrieve from the MIB 5 data (MIB data) about the network resources 3. 
The upgrade advisor 1 1 then retrieves upgrade information from the upgrade database 9 and performs two types of 

45 comparisons: a) whether or not a particular upgrade package corresponds to a resource on the server, and b) whether 
or not the version number of the upgrade package matches the version nun^er of the corresponding network resource 
(i.e. whether or not the upgrade package represents a true upgrade for the existing network resource). If the upgrade 
applies to a resource on the server and if the iq^graded and current versions of the network resource do not match, tiie 
upgrade advisor 1 1 uses additional information from the upgrade database 9 to analyze the level of severity of tiie 

so upgrade. i.e.. to determine the importance of the upgrade to the efficient operation of the server. The upgrade advisor 
is described in more detail below. 

Referring also to Rgures 2 through 4. the upgrade dataljase may also contain information about a resource (e.g.. 
a driver) which is not recognized by tiie server manager. In this situation, the upgrade advisor places information at^ut 
the resource (e.g.. name, versbn number) into a driver tabAe 22 in the MIB 5. An agent 21 of the server manager located 

55 in the server uses this information to search for the resource (i.e.. to see if the resource has been installed on tiie 
network). If so. the server manager creates entries for the resource in tiie server database. 

When the upgrade advisor 1 1 and/or the user have selected 1 00 the network resources 3 that need to be upgraded, 
an upgrade installer 1 7 oversees the automatic installation of the packages to the server. At the outset, the appropriate 
upgrade packages 7 are retrieved 1 02 from the dtetrSxition medium (or the on-line service) and supplied 1 06 to a server 
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upgrader 22 located in the upgrade installer 17. Installation instructions 20 are retrieved 104 from ttie database 9 and 
are sillied 106 to the server upgrader 22. The instructions are coded in a unique package scripting language (PSL). 
which can be read and executed at the time of installation. Rules of syntax for a preferred PSL are listed in Appendix A. 
In the server upgrader 22. several upgrade packages 7 and the corresponding installation instructions 20 are grouped 

5 108 into a lob** 18. Within each job 18. the installation instructions for every package are included in a control file 18a. 
The control file also includes a pre-appointed time at which the installatfon of tiie packages in the job should be carried out. 

When the job 18 is ready to be Installed to the target server, the server upgrader 22 connects 109 with the server 
through a login service 24 and then sends 1 1 0 the job 1 8. including the control file 1 8a. to a staging area 1 9. The staging 
area 19 may be in the target server, in the server manager, or anywhere else in the network capable of handling the 

10 deposit and retrieval of upgrade files. Within the staging area 1 9, each package is placed into a corresponding package 
directory 71 , and the control file is stored separately. The server manager then notifies 112 the agent 21 that a job has 
been sent to the staging area 1 9. When the pre-appointed time arrives 1 1 4. the agent 21 executes 116 the instructions 
in tiie control fOe, thereby installing the packages from the package directories 71 to the target network resources 3. 
The agent then deletes 1 17 the control file from the staging area 19. 

IS Before the packages are installed to the targets, the agent 21 may store 1 1 5 the older revision levels of tiie resources 
on a local hard disk 23. As a result the user always has access to previous versions of the resources. Maintaining old 
versions of upgraded resources allows the user to downgrade the resource, if needed, in the future. 

After the installation is complete, job status data 73 is generated 118 and temporarily stored 1 20 in a results directory 
75 in the staging area 19. The agent 21 retrieves the job status data 73 from the results directory 75 and places 122 it 

20 into a job status table 34 in the MI6 5. A results manager 26 in the upgrade installer monitors the MIB 5 for the job status 
data 73 and retrieves 1 24 the data as soon as it appears. The results manager 26 then sends 1 25 the data to a history 
manager 28. which tracks the history of upgrades on the server. The history manager 28 is responsible for providing 
126 the history information to the user (or to storage). The server upgrader 22 then cleans 128 the staging area of any 
extraneous infbrrration. Because a single copy of a package may be used to upgrade a resource on multiple servers 

25 (using multiple control files), tiie packages are left 130 in the staging area 19 by tiie server upgrader. 

Referring to Figures 5A through 5C, the upgrade database actually consists of tiiree databases: a "Package** data- 
base 25. a "Description" database 27. and a "How^To" database 29. The Package database 25 contains the information 
which associates upgrade otiiects with each package, as well as the information needed to retrieve a package from the 
distribution medium (CD-ROM) and properly install the package to tiie server. For each upgrade package, the database 

30 maintains a unique package number 25a arxl a count 25b of the numt>er of database recoids (ue., upgrade objects) 
associated witii the package. In addition, the version number 25c and the upgrade date 25d of the package are main- 
tained. The Package database also maintains the name 25e of the package and the location 25f of the package on the 
CD-ROM CD drive and directory name). To enable automatic installation of the package, the database contains 
the package scrpt 25g (the installation instructions for the package). The database also contains information regarding 

35 the dependencies between the package and other upgrade objects or packages: child dependendes 25h are the upgrade, 
objects associated with a package; sibling dependencies 2^ are the packages upon which a package d^ends; and 
p>arent dependencies 25i are tiie packages or upgrade objects which together constitute a larger package. Rnally, the 
datat^se indicates whetiier or not the package can be selected by the user for upgrade and whether or not the package 
can t>e displayed to the user tiirough a user interface. 

40 While each upgrade distribution medium will commonly contain all upgrade packages upon which a particular 
upgrade depends, it is also likely that upgrades to a package will depend upon upgraded packages not stored on the 
distribution medium. For example, the printing capabilities of an upgraded word processor created by one vendor may 
depend upon an upgrade to a printer driver produced by another vendor. While it is unlikely that the word processor 
upgrade and the driver upgrade will be distributed on the same CD. the user should still be informed of the dependency. 

45 Therefore, the dependency information in the Package database 25 describes not only the dep^dendes between pack- 
ages on the CD. but also all dependendes between an upgrade package and any upgrade not available on the CD. Even 
though the unavailable upgrades cannot be automatically installed with the available upgrades, the user is nonetheless 
aware of their necessity. 

The Description database 27 stores information that descrfoes each upgrade found in a packaga Induded in this 
so information are the package nurrd^er 27a and record count 27b. as well as the version number 27c and date 27d of the 
upgrade. A description 27e of the change between tiie updated version and the previous version of the upgrade object 
is also provided. Because a server may contain any previous version of a resource, the database must maintain a 
description of the changes between each version. The description 27e includes reasons why the upgrade is necessary, 
drawing information from development release notes, test reports and field service reports. The type 27f of upgrade 
55 made to the object (e.g.. feature enhancements, performance enhancements or bug fixes) and the importance 27g of 
the upgrade (e.g.. high, medium or low) are also indicated in the Description database 

The How_To database 29 supplies information which allows the upgrade advisor to compare the upgrade information 
to the MIB data (MIB items) from the server. As in the Package and Description databases, the package number 29a is 
maintained. Within the How.To datat>ase. each record r^resents an individual piece of MIB information corresponding 
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to the particular package. Each record Is Identified by a record number 29b. A unique internal number 29c is assigned 
to allow the upgrade device to identify the MIB item and comparison service specified in the record. The database also 
maintains the name 29d of the MIB item maintained in the record, as well as the name 29e of the comparison service 
which will use the MIB item to perform the comparison. 

5 The items to be compared may be string data 29f (e.g., the name of the package) or numeric data 29g. and the 

comparison service is selected accordingly. The comparison service is also selected according to the type 29h of com- 
parison, i.e.. a) whether the package applies to the server, or b) whether the upgraded version differs from the current 
version. The comparison group number 29t allows the upgrade advisor to group comparison results with related results. 
Referring also to Figure 5D, the first package 26a in the Package database 25 is linked to description records 28a. 

10 28b, 28c in the Description datat^se 27. In this case, the description records corresponding to the package 26a provide 
detail on earlier versions of the package, thus enabling the upgrade advisor to analyze the changes between each 
version. The package 26a is also linked to the comparison records 30a, 30b, 30c in the How_To database 29. each of 
which describes the MIB data required to compare the current version of the package to the upgrade. The second 
package 26b and subsequent packages in the Package database are likewise linked to the corresponding records in 

15 the Description and How_To databases. 

Referring to Figures 6 through 10, when the user initiates 200 the upgrade advisor, a list box object 33 is created 
202, and a Windows list box 51 is displayed to the user. The list box object 33 creates 204 a server view object 35 for 
each server in the network. When a server is selected 206 by the user, the corresponding server view object 35 places 
208 the server name 53 into the list box 51. The server view object 35 then creates 210 package view objects 49 to 

20 handle package information during the comparison process. 

A package query object 43 retrieves 21 1 package data from the Package database and uses the data to create a 
package object 45 for each package. The package object is responsible for collecting information about the correspond- 
ing package, including a description of the package, pointers to the MIB check objects 37 that apply to the package, and 
pointers to (parent child, and sibling packages. A MIB query object 38 retrieves MIB location inforrration for each MIB 

2S item from the server database 1 3 and then uses the information to retrieve 21 2 MIB data and comparison service infor- 
mation from the server. Comparison service information Identifies the appropriate service to handle the comparison of 
each piece of MIB data. The MIB query object then creates 213 MIB check objects 37 responsible for handling the 
comparisons between MIB data and upgrade data. A description query object 39 uses information from the Description 
database to create 214 a description object 41 for each upgrade Object contained in a package. 

30 When all of tiie objects are created, a MIB manager object 31 determines 21 5 which MIB items should be retrieved 
from tiie selected server. A request for the MiB data is sent 21 6 to the data retriever (1 5 in Figure 1 ), which gathers 21 8 
the requested information from the MIB in the selected server and forwards 220 the data to the list box object 33. As 
the MIB items are received by the upgrade advisor, the list box object 33 identifies 222 the server which sent the data 
and forwards 224 the data to the appropriate s^er view object 35, where the MIB items are queued 226. When all 

35 \tenrs have been received from tiie server, the server view object 35 sends 228 the MIB data to tiie MIB manager object 
31 . The MIB manager object then identifies 230 the appropriate MIB check object 37 to process each piece of MIB data 
and distributes 232 the data accordingly. 

As tiie MIB data makes its way from the server to the MIB check object, the con^esponding upgrade description 
information is retrieved 234 from the Description datat^se by the description query object 39. Each upgrade description 

40 is then forwarded 236 to the corresponding description object 41 . From the description objects 41 , each package object 
45 collects 238 the upgrade descriptions pertaining to tiie package. The package object 45 then sends 240 each piece 
of upgrade data to the appropriate MIB check object 37 for comparison to corresponding MiB data. 

Once the MIB check otDjects 37 have received the appropriate MIB data and upgrade data, the data is sent 244 to 
the appropriate comparison service 47, according to the comparison information retrieved from the MIB. After the data 

45 is compared 246, the comparison service 47 returns 248 a comparison result to the MIB check object where tiie result 
is stored 250. 

In order to display or report upgrade advice to the user, the server view object 35 requests 300 package status 
information from tiie package view object 49. TTie package view object 49 in turn requests 302 the status information 
from the package object 45. Using pointers, ttie package object 45 determines 304 which MIB check objects 37 contain 

so the conparison results for the corresponding package. The package object then retrieves 306 the results and combines 
308 them to determine package status (i.e.. whether or not the package applies to the server, and whether the package 
needs to be upgraded on the server). Once the status of the package is determined, the package status information is 
passed 3 1 0 to the package view object 49. If the status information indicates that the package applies 3 1 2 to the server, 
the package view object adds 314 the package 55 to the server 53 in the list box 51. The status information is then 

55 passed 316 to the saver view object 35, where it is displayed 318 to the user in ttie list box 51 . 

The importance of an upgrade 57 (high, medium, low) is displayed to the user tiirough color coded vidual objects 
58 (e.g.. red. yellow, green). The reasons 59 for the upgrade (i.e, upgrade description) are a^ displayed in tiie list box 
51. When requested by the user (e.g.. with a "Details** tDutton 60), additional details about tiie upgrade are displayed 
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320 in a detail window 65. In addition to displaying the output of the upgrade advisor, a report may be generated 322 
by the upgrade advisor. The upgrade advisor may also store 324 the status results. 

Referring to Rgure 11 . the upgrade advisor and installer may also be used to analyze the availability of upgrades 
and generate upgrade jobs for individual clients 80 connected to the server. In this situation, the client, like the server. 
'5 contains a MIB 81 which maintains information about the resources 83 currently installed on the client. When the user 
invokes the upgrade advisor, the MIB data is retrieved from the MIB 81 and the comparisons are carried out as described 
above. 

The client resources 83 may then be upgraded in two ways: automatically through the upgrade installer, or manually 
with upgrade diskettes 85 automatically created by the upgrade device. If automatic update is chosen, the upgrade 

10 installer builds tiie selected upgrade packages and installation instructions into a job (as discussed above), which is 
transferred into a staging area. An agent 87 in the client 80 is then notified that a job has been placed in the staging 
area, and the agent installs the packages in the job according to the installation instructions. Alternatively, the client may 
be programmed to search the staging area at specific times (e.g.. start-up) for jobs it needs to install. 

If manual update is chosen, the packages selected for upgrade are stored to a diskette 85. along with the corre- 

IS spending installation instructions. When all of the packages have been placed onto the diskette, the user places the 
diskette into a disk drive (not shown) on tiie client, and the agent automatically installs tiie packages according to the 
installation instructions. 

As an example of the operation of the upgrade advisor and upgrade installer, assume that the distrbution medium 
contains an upgrade package called Novell Programs. Within the Novell Programs package is an upgrade object corre- 
20 sponding to each of the NetWare drivers installed to the target server. When the distribution medium is inserted into the 
drive, the upgrade advisor reads information about the Novell Programs package from the Package database. The 
upgrade advisor then retrieves from the Description database description information for the upgrade objects in the 
package. The records con-esponding to each upgrade object are tiien read from tiie How_To database and compared 
to the description Information. 

25 As shown in the chart below, the first record for the Novell Programs package contains information about the oper- 
ating system running on tiie server: The first entry in the record is the name ("cpqHoName") of the MIB data for the 
records. This entry causes tiie upgrade advisor to retrieve the name of the operating system that the server is running. 
The second entry informs the upgrade advisor that a "stringcompare" comparison service will be used to compare the 
upgrade and MIB data. The third and fourth entries pass the corresponding description Information to the oomparisdn 

30 service. For record number 1 , tiie MIB data is conrpared to the string "NetWare". Since string data is to be compared, 
the "numeric data** entry is ignored. The last entry for the record informs the upgrade advisor that the type of comparison 
to be performed is a determination of whether or not the NetWare OS applies to the seryer, i.e., if the OS runs on tiie 
server. 

The second record contains the information necessary to determine whether or not the netware "NPFC" software 
35 is available on the saver. If so. the information in the third record enables a comparison of the version number of the 
upgrade with tiie version number on the server. 



Record # 


mibdata 


comparison service 


string data 


numeric data 


type 


1 


cpqHoName 


stringcompare 


Netware 


N/A 


applies 


2 


cpqSWVerName 


stringcompare 


NPFC 


N/A 


applies 


3 


cpqSWVerVersion 


versioncheck 






version 



45 

When the upgrade advisor receives all of the comparison results from the conparison services, the results are used, 
first, to determine whether or not the Novell Programs package is an upgrade which can be installed to the server and. 
second, to advise tiie user of the inportance of tiie upgrade. Assuming that an upgrade to the Novell Programs package 

so is txDth available and desired, the user selects the package as one to be upgraded. The upgrade installer is then invoked. 
The upgrade installer retrieves the Novell Program's package from the distribution medium and the corresponding 
installation instructions from the How_To database. The package and instructions are then incorporated into a job. which 
includes a command to run the job at nrddnight. The job, tnducfing the Novell Programs package and the control f ile, is 
copied into the staging area and tiie agent on the target server is notified of its presence. When the agent looks at tiie 

ss job. it sees the command to run the job at midnight and warts until that time arrive At midnight the agent calls an install 
application to automatically install the Novell Programs package. When the installation is complete, the agent stores 
results information, including the name of the job and the time at which it was executed, into the job status table of the 
MIB. The upgrade installer then retrieves this information and provides it to the user. 
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Other embodiments of the invention are within the scope of the following claims. 

APPEKDIX A 

Package Script Language 

A Package Script Language (PSL) is defined that should make it easier for 
package owners to develop installation scripts for their products. 

Commands 

The installer will look for a .PSL file and begin executing it. PSL 
commands are: 

MKOIR I/err] < directory > 

COPY l/ul I/errl < source > <destination> 

DELETE [/err] < source > < destination > 

RUN_[os] [/err] <executable> [...parameter list...] 

Where, 

/u - add the opposite of this command (or copy < destination > 
<sottrce> ) to the UNDO.PSL file (see below) 

/err - on error, stop script proccssmg and report a package failed 
status (run undo.psl and report failed in job status table.) 

<source> - source file to copy * can be any number of 
specifications: 

d:(\directory\J < filename > 

\ \serverisfuzre {[directory \] < filename > 

SYSPART:[\directory\J<filename> 

<destinadon> - destination for file - see specs for <x> 

OS - defined as NT (WinNT), 02 (OS/2). SO (SCO UNIX), UW 
(UnixWare), and NW (NetWare). 
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For COPY, any file attributes will be preserved but ignored (i.e., 
copying over a Readonly doesn't cause an error). 



Section Headings 

Each PSL is broken into sections designated by a section heading. There 
are four special section heading names that the script processor will look to 
execute. The headings are executed in this orden Main, EISA ID, OS, 
and User Defined. 

[Main] - section is run on ail machines 

[EISAreisalD] - section is executed if board with ID q>ecified is installed. 
EISA ID is specified: CPQXXXX where X can be an alphanumeric 
character or to match any alphanumeric in that position. 

[WinNT i NetWare | UNIX i OS/2] - section should be run on madiine 
if specified OS b running. 

[<user defined > ] • a user defined section. It must be immediately 
followed by: 

DISCOVERJos] » <executable> - executable should return 1 for 
exe cut e remainder of section, or 0 for skip section. OS is defined as NT 
(WinNT), 02 (OS/2), SC (SCO UNIX), UW (UnixWare), and NW 
(NetWare). 

[UNDO_BEG] - this section defines the <undo> .PSL file. The presence 
of this section causes the interpreter to create an <undo> .PSL file based 
on the naming. The [undo] section contains: 

filename— < undo> .psl • or the name of the undo file to be 
created, 

<any other text> - this text is added to the undo file untouched, 
[UNDO^BEG] - the end of the undo section. 



Claims 

1- A method for use in upgrading a resource of a computer from an existing version of the resource to a later version 
of the resource, comprising 

digitally storing upgrade information which identifies the later version and describes features of the later 
versfon relative to one or more eariier versions of the resource. 

digitally storing in the compjter information kSerrtifying the existing version. 

by computer, automatically determining which of the earlier versions is the existing version, and 



8 



EP0 703 531 A1 



based on the results of the comparing step, automatically determining, or displaying to a user at least some 
of the upgrade information to aid the user in determining, whether to perform an upgrade. 

2. The method of claim 1 wherein the upgrade information is stored on a portable medium, the later version of the 
5 resource is also stored on the portable medium, and the upgrade Information identifies the location of the resource 

on the portable medium. 

3. The method of claim 2 wherein the portable medium comprises a CD-ROM. 

10 4. The method of daim 2 wherein the portable medium contains stored later versions of multiple resources, and 
upgrade information with respect to each of the resources. 

5. The method of claim 1 wherein the upgrade information is stored within an on-line service. 

IS 6. The method of claim 1 wherein the upgrade irrfornnation is stored in the form of a database. 

7. The rhethod of daim 1 wherein the upgrade information further conrprises instructions for installation of the resource. 

8. The method of daim 7 wherein the Installation instructions are expressed in accordance with a predefined common 
20 syntax. 

9. The method of claim 1 wherein the resource connprises a complete standalone software package. 

10. The method of claim 1 wherein the resource comprises less than all of a conplete standalone software packaga 

25 

11. The method of claim 1 further comprising automatically performing the upgrade on a network server. 

12. The method of claim 1 1 wherein automatically peHbrming the upgrade on the network server comprises 

storing on a storage medium the existing version of the resource, and 
30 repladng on the server the existing version of the resource witfi the upgrada 

1 3. The method of claim 1 further comprising automatically performing the upgrade on a network client 

1 4. The method of claim 1 3 wherein the upgrade is performed via the network. 

35 

1 5- the method of daim 1 3 wherein automatically performing the upgrade on the network client comprises 
storing on a storage medium the existing version of the resource, and 
replacing on the client the existing version of the resource with tiie upgrade. 

40 16. The method of claim 1 3 wherein the upgrade is performed by automatically storing the later versions and installation 
instructions on a portable storage medium for manual installation on the client. 

1 7. The method of daim 1 wherein the upgrade information includes information oonceming reasons for the later version. 

45 18. The method of daim 1 wherein the upgrade information includes an indication of the type of change from a prior 
version to the later version. 

1 9. The method of claim 1 8 wherein the type may indude feature enhancem&it. performance enhancement, or bug fix. 

so 20. The metiiod of daim 1 wherein the upgrade information includes an indication of tiie importance of the change from 
the prior version to the later version. 

21. The method of daim 1 wherein the upgrade information includes information identifying other resources tfiat must 
be upgr^ed before the resource may be up)graded. 

ss 

22. A method of sipplying later versions of resources for upgrading existing versions comprising storing, on a portable 
medium, copies of the resources an6 upgrade information which identifies the later versions, descrfoes features of 
the later versions relative to one or more earlier versions of the resource, and provides instructions, in accordance 
wHh a predefined common syntax, for installing each of the resources. 
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23. The method of claim 22 wherein the upgrade information includes information concerning reasons for the later 
versbn. 

24. The method of claim 22 wherein the upgrade information includes an indication of the type of change from a prior 
version to the later version. 

25. The method of claim 22 wherein the upgrade information includes information identifying other resources that must 
be upgraded before the resource may be upgraded. 

26. The metiiod of claim 22 wherein the copies of the resources and the upgrade information are stored on a portable 
medium. 

27. The method of claim 22 wherein the copies of the resources and the upgrade information are stored within an on- 
line service. 

28. A method for use in upgrading a resource of a computer from an existing version of the resource to a later version 
of the resource, comprising 

digitally storing, on a portable medium, the later version of the resource and upgrade information which 
identifies the later version, 

describes features of the later version relative to one or more eariier versions of the resource, 
identifies tiie location of the resource on the portable medium, 
provides instructions for installation of the resource, 
describes reasons for the later version, 

indicates the type of change from a prior version to a later version, and 
indicates the importance of tiie change from a prior version to the later version, 
digitally storing in the computer information identifying the existing version, 
by computer, automatically determining which of the earlier versions is the existing version, 
based on the results of the comparing step, automatically determining, or displaying to a user at least some 
of the upgrade information to aid the user in determining, whether to perform an upgrade, and 
automatically performing the upgrade. 
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